Open topic with navigation

KMF Integration Service - Manual Upgrade: Upgrading Kony MobileFabric Integration Service > WebLogic > Upgrade WebLogic Manually from 6.0.x to 6.5.x

Upgrade WebLogic Manually from 6.0.x to 6.5.x

This section provides you the steps to upgrade Kony MobileFabric Integration Service manually from 6.x to 6.5.x (WebLogic). Assume that you have prior installation of Kony MobileFabric Integration Service.

Prerequisites

The following table displays the prerequisites for upgrading Kony MobileFabric Integration Service.

Refer to http://community.kony.com/downloads/manual to download the following artifacts:

Artifacts Type Purpose
Respective Database Upgrade scripts Database Scripts To setup the required schema
  • admin.war
  • middleware.ear
  • metrics.ear (applicable only for metrics)

    (Advantages)

 WAR and EAR files

To be deployed to Application Server
  • libraries-MIDDLEWARE-GA-<6.x>.tar
  • middleware-bootconfig.tar
TAR files  

Backup

To backup files, follow these steps: 

  1. Stop the application server.
  2. Take a backup of the following files from your current server installation location.
    1. These files are available at <Weblogic_install_dir>\user_projects\domain\your_domain .
      • middleware.ear
      • admin.war
      • metrics.ear (applicable only for metrics)
    2. middleware-bootconfig directory available at <middleware-home>\middleware\middleware-bootconfig>
    3. middleware libraries (.JAR files) - The files are located at <middleware-home\lib\middleware.
    4. After taking the backup, delete all the above files.

Execute Database Upgrade Scripts (Applicable Only For Metrics)

To execute the database upgrade scripts downloaded in the prerequisites step, follow these steps:

  1. Execute the database upgrade scripts of GA-6.5.0 from http://community.kony.com/downloads/manual.

    Note: Run the scripts in given order. Replace the names of konyadmin and konyreports schema to your respective schemas.

  2. In Konyadmin DB, add the following entries (if not available) into PROP_NAME and PROP_VALUE columns of mobilefabric_configuration table:
    • management_server_hostname with your WebLogic administration console IP
    • management_server_port with WebLogic administration console port
    • management_server_username with WebLogic Username
    • management_server_password with WebLogic Password
    • management_server_groups with the name of the cluster or servers to which the apps should be deployed when published from IDE separated by comma.

Add New and Update Existing Property Files

middleware-bootconfig of 6.5.x is bundled with few additional .properties files compared to earlier versions that are required during the upgrade process. You would also need few .properties files from your backup location.

To add new and update existing property files, follow these steps: 

  1. Download and extract the middleware-bootconfig.tar file downloaded in step 2b from Backup section, to the <middleware-home>\middleware directory.

    The following new property files extracted are applicable only for metrics

    1. metrics-log4j.properties in the middleware-bootconfig folder that is available under middleware home.
    2. admin-log4j.properties and serverconsole.properties in the admin folder available under middleware-bootconfig.
  2. Retain admin-log4j.properties and deployment-config.properties from your backup location <middleware-bootconfig>/admin to <middleware-home>/middleware/middleware-bootconfig/admin>.
  3. Retain the changes made to middleware.properties and middleware-log4j.properties files from previous version.
  4. Open middleware-log4j.properties and edit the below path for device-payload.log and datasource-payload.log 
    log4j.appender.DEVICE.File = ${middleware.home}/../logs/middleware/device-payload.log
log4j.appender.DATASOURCE.File=${middleware.home}/../logs/middleware/datasource-payload.log

  5. Copy the appregistry folder of middleware-bootconfig from the previous version to the new middleware-bootconfig folder.

  6. If metrics is not used, open middleware.properties and mark the property as false.

    metrics.logging=false

    Note: This property is introduced from version 6.0.3.3.

    Note: If we set metrics.logging property to false, call the kony.license.disableMetricReporting() API in app init to disable “Maximum Offline Sessions Exceeded” alert.

  7. Retain the metrics-log4j.properties in the middleware-bootconfig folder and serverconsole.properties in the middleware-bootconfig\admin from the previous version (applicable only for metrics).

Deploy the latest .WAR Files

To deploy the latest WAR files, follow these steps: 

  1. Deploy the latest admin.war, middleware.ear and metrics.ear (applicable only for metrics) files to the application server from the Deployments tab of WebLogic Administration Console and provide the target as the cluster or servers in which Kony MobileFabric Integration Service is configured.
  2. Extract the JAR files available in libraries-MIDDLEWARE-QA-ver.tar to this location - \<middleware-home>\lib\middleware.

    3. Important: Start the server or cluster from the Servers tab under Environments in the left menu of the Administration Console.

Verification

Verify the upgrade process by logging into the console and look for Server Version and Health Check. Use version.html for verification.

To verify the upgrade process, follow these steps:

  1. Navigate to the URL http://ipaddress:port/admin/version.html and look for server version.
  2. Navigate to Settings and click Health Check and look for Report DB, Admin DB and Reporting Queue.

    Note: Status should be in PASSED state.

  3. Navigate to Settings and click Configuration.

Copyright © 2013 Kony, Inc. All rights reserved.

Open topic with navigation